<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<!-- saved from url=(0028)http://jdbi.org/archive.html -->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"></meta>


<title>abacus-common</title>

<script type="text/javascript" src="./css/ga.js"></script>
<script type="text/javascript">
	if (top.location != self.location)
		top.location.replace(self.location);
</script>

<link href="./css/css" rel="stylesheet" type="text/css"></link>
<link href="./css/css(1)" rel="stylesheet" type="text/css"></link>
<link rel="stylesheet" href="./css/syntax.css" type="text/css"></link>
<link rel="stylesheet" href="./css/screen.css" type="text/css"></link>

<script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

  ga('create', 'UA-65247258-1', 'auto');
  ga('send', 'pageview');
</script>

</head>
<body>
	<div id="site">
		<h1>
			<a href="./index.html">abacus-common</a> <span id="navigation"> <a href="./docs.html">Docs</a> | <a href="./download.html">Download</a> | <a
				href="./api-docs/index.html">Javadoc</a> | <a href="./faq.html">FAQ</a> | <a href="./community.html">Community</a>
			</span>
		</h1>
	</div>

	<div id="content">

		<div id="page">

			<h1>Model/Entity</h1>
			<p>
				<a href="http://www.scaledagileframework.com/domain-modeling/">Model/Entity</a> is the abstraction of real world. defining a good Model/Entity will make programming much easier, for example:
			</p>
<!-- HTML generated using hilite.me --><div style="background: #f8f8f8; overflow:auto;width:auto;border:solid gray;border-width:.1em .1em .1em .8em;padding:.2em .6em;"><pre style="margin: 0; line-height: 125%"><span style="color: #408080; font-style: italic">// Without Model/Entity object.</span>
Document doc <span style="color: #666666">=</span> <span style="color: #008000; font-weight: bold">new</span> Document<span style="color: #666666">();</span>
doc<span style="color: #666666">.</span><span style="color: #7D9029">put</span><span style="color: #666666">(</span><span style="color: #BA2121">&quot;gui&quot;</span><span style="color: #666666">,</span> N<span style="color: #666666">.</span><span style="color: #7D9029">uuid</span><span style="color: #666666">());</span>
doc<span style="color: #666666">.</span><span style="color: #7D9029">put</span><span style="color: #666666">(</span><span style="color: #BA2121">&quot;firstName&quot;</span><span style="color: #666666">,</span> <span style="color: #BA2121">&quot;jack&quot;</span><span style="color: #666666">);</span>
doc<span style="color: #666666">.</span><span style="color: #7D9029">put</span><span style="color: #666666">(</span><span style="color: #BA2121">&quot;lastName&quot;</span><span style="color: #666666">,</span> <span style="color: #BA2121">&quot;ye&quot;</span><span style="color: #666666">);</span>

<span style="color: #408080; font-style: italic">// With Model/Entity object.</span>
Account account <span style="color: #666666">=</span> <span style="color: #008000; font-weight: bold">new</span> Account<span style="color: #666666">().</span><span style="color: #7D9029">setGUI</span><span style="color: #666666">(</span>N<span style="color: #666666">.</span><span style="color: #7D9029">uuid</span><span style="color: #666666">()).</span><span style="color: #7D9029">setFirstName</span><span style="color: #666666">(</span><span style="color: #BA2121">&quot;jack&quot;</span><span style="color: #666666">).</span><span style="color: #7D9029">setLastName</span><span style="color: #666666">(</span><span style="color: #BA2121">&quot;ye&quot;</span><span style="color: #666666">);</span>
</pre></div>

		<p></p>
		<p>Here the differences are not jsut about lines of code, you have to deal with tens/hundreds of key names and the data types.
		Someone may think: "I'm using NoSQL. Model/Entity object is unnecessary". That's not true. Model/Entity decides how the data/logic in real world will be processed in program, which is not related to the technologies of data store. 
		Defining a good model/entity will:</p>
		<li>Make reading/saving/transfering/manipulating data much easier</li>
		<li>Simplify the system design and implementation</li>
		<li>Reduce a lot of extra headaches which could be introduced by bad/no Model/Entity</li>
		<li>...</li>
		<p></p>
		<p>There is also a good example about how programming can be simplified by Model/Entity: <a href="./sqlite-executor.html">SQLite Executor</a></p>
		<p>Model/Entity is not just key/value, it's much more than the key/value structure Map/Document/ContentValues...</a></p>

		</div>

	</div>
</body>

</html>